<?php
/*!
 * LostKids API PHP Library v0.1 
 * http://huali.li/
 *
 * Copyright 2011, 
 * Written By James Pang
 *  
 * Date: 2011/2/14
 */

/**
 * adaptor for msg source
 */
interface MsgSrcPlugin {
    /** 查拍到的照片的关键字 */
    const KEY_REPORT = '查询'; // UTF-8
    /** 已丢失人登记的关键字 */
    const KEY_SEEK = '寻找'; // UTF-8
    /** 回复匹配的关键字，后面必须紧跟userId */
    const KEY_MATCH = '匹配'; // UTF-8
    /** 没有匹配，注册新user */
    const KEY_NON_MATCH = '无匹配'; // UTF-8
    /** 回复找到的关键字，后面必须紧跟userId */
    const KEY_CONFIRM = '找到'; // UTF-8
    /** 中断符号 */
    const KEY_DELIM1 = '#'; // UTF-8
    const KEY_DELIM1_ALT = '＃'; // UTF-8

    /**
     * @return WeiboMessage[], not null
     */
	function retrieveMsgs($dataSrcKey, $maxCnt = 100);

    /**
     * respond to a msg
     */
    function respondMsg($msgId, $ownerId, $content);
}
?>
